REST Api list incidents or get incident does not have correct description

#1

It seems that when I create a ā€˜testā€™ incident via the website, the title of the incident and description of the incident are different. However, when reading this incident via the REST API, both title and description are the ā€˜titleā€™ value. Seems like the ā€˜descriptionā€™ field is returning the title when using the REST API.

For example:
TITLE
this is a test alert.
DESCRIPTION
a test alert created by eric - please donā€™t do anything to acknowledge or resolve.

both the ā€˜titleā€™ and ā€˜descriptionā€™ fields return ā€˜this is a test alertā€™

#2

Are you following out REST API Reference Sheet? The title of the incident is listed as ā€œtitleā€, but the description of the incident (i.e. the incident contents) are listed as ā€œdetailsā€ under ā€œbodyā€. If you still have trouble after checking out the URL I linked, could you post the API payload youā€™re sending so I can take a look at what youā€™re attempting?

#3

It is not returning the data,

curl -X GET --header ā€˜Accept: application/vnd.pagerduty+json;version=2ā€™ --header 'Authorization: Token token=ā€˜redactedā€™ ā€˜https://api.pagerduty.com/incidents/P4TY7FAā€™

I am not POSTIng an incident, Iā€™m trying to ā€˜GETā€™ one. And it always returns the title and description as the ā€˜titleā€™

#4

This definitely looks a little wonky.

I donā€™t believe the REST API should be providing the description in the incident to begin with. You would normally need to use the log entry of the incident where the type is trigger_log_entry to view the description under the event_details but this also showed the title in the location the description should be.

Thanks for letting us know and I apologize for the inconvenience. Iā€™ve submitted a bug to our engineering team regarding this.

#5

I disagree, i want the title and description fields, i think the only bug here is that the description is being returned as the title. Thanks for letting the dev team know.

#6

Iā€™ll confirm if this is expected as well. I do not see description for the incident listed under the response schema of the documentation for GET /incidents except in the serviceā€™s description which is why I donā€™t believe it is expected except in the GET /log_entries.